home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / wb / MagicEYE.lha / magiceye / MagicEYE.dok < prev    next >
Text File  |  1995-06-17  |  10KB  |  169 lines
  1.         __       __
  2.         )\\     /((  Version 37.1                            __
  3.        /  \\   /  \\         39.1  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / //    @ 1995 by    \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.          sMail:                     eMail:                 _______  ___ _____
  13.      Christian Krapp                                      / __//\ \/ /// __//
  14.      Hagenmähderstr.9   krabbe@informatik.fh-augsburg.de / _//   \  /// _//
  15.    D-86391 Stadtbergen                                  / //__   / /// //__
  16.      (GERMANY)                                          \___//  /_// \___//
  17.  
  18. --------------------------------------------------------------------------------
  19.  
  20. Copyright:
  21.   Dieses Programm  und alle dazugehörige Dateien (Programm-Icon) sind  Copyright
  22. 1995  bei Christian 'cr8y' Krapp! Es  darf nur  im unveränderten Zustand weiter-
  23. gegeben  werden.  Eine Gebühr, die über den üblichen  Disketten-Preis  zuzüglich
  24. einer geringen Kopiergebühr liegt, darf nicht  erhoben werden.  Desweiteren darf
  25. dieses Programm nicht ohne Genehmigung auf eine PD-Serie oder eine  CD-Rom über-
  26. nommen werden. Diese Genehmigung ist beim Autor erhältlich und wird in der Regel
  27. gegeben.
  28.  
  29.   Nur  für die  AmiNet, FreshFish, und  MeetingPearls  CD-Rom-Serien  sind keine
  30. Genehmigungen nötig.
  31.  
  32.   Dieses Programm  ist weder Public Domain noch Shareware. Es wurde als Freeware
  33. freigegeben.  Jeder der dieses Programm  benutzt sollte mir  eine Postkarte oder
  34. eMail schicken  (Schließlich würde  es mich interessieren, wieviele Leute dieses
  35. Programm benutzen).
  36.  
  37. --------------------------------------------------------------------------------
  38.  
  39. Einführung:
  40.   Nein: Dieses Programm ist kein weiteres Programm zum Berechnen von 3D Bildern.
  41. Jeder Amiga-Benutzer  dürfte inzwischen  MagicWB  (und die  zusatz  Icon-Pakete)
  42. kennen.  Auch dürften die  verschiedenen Gag-Programme  bekannt  sein,  die  ein
  43. Augenpaar auf dem Bildschirm anzeigen, das dem Mauszeiger "verfolgt". Doch eines
  44. hat  mich schon immer  gestört: Diese Augen passen  nicht ganz zum Rest  der mit
  45. MagicWB  aufgepeppten Workbench,  da  die  meisten dieser Augenprogramme mit SW-
  46. Augen arbeiten.  Aus diesem  Grund hab ich mir  die  "Arbeit"  gemacht  und  ein
  47. farbiges Augenpaar erstellt.
  48.  
  49. --------------------------------------------------------------------------------
  50.  
  51. 4 Gründe, dieses Programm zu benutzen:
  52.  
  53. 1.) Die Augen sind Bunt ;^)
  54. 2.) Bei Änderungen der Einstellungen wird das Fenster kurzzeitig geschlossen.
  55. 3.) Viele Parameter sind einstellbar.
  56. 4.) Patch, damit sich das Augen-Fenster wie die Screentitelleiste verhält.
  57.  
  58. --------------------------------------------------------------------------------
  59.  
  60. Was wird benötigt?
  61.   Auf jeden  Fall braucht  man einen  Amiga-Computer  (oder kompatibel ;^) ) mit
  62. mindestens AmigaOS  2.04 oder höher. Leider  kann ich nicht garantieren, daß die
  63. Programmversion  für AmigaOS 2.04  funktioniert, da  ich nur  einen  Rechner mit
  64. AmigaOS 3.0  besitze. Desweiteren sollte  die Workbench mit mindestens  8 Farben
  65. und einer  möglichst quadratischen-Auflösung  (z.B. 640×512)  betrieben  werden.
  66. Auch sollte  möglichst die  MagicWB-Farbpalette  benutzt  werden,  da  die Augen
  67. darauf abgestimmt  sind. Desweiteren sollte  für die  Bildschirmtitelleiste  ein
  68. Zeichensatz mit mindestens der  Größe 13 benutzt  werden, da ansonsten die Augen
  69. über die Titelleiste hinausstehen.
  70.  
  71. --------------------------------------------------------------------------------
  72.  
  73. Die verschiedenen Programm-Versionen:
  74.   Es ist eigentlich sehr einfach: Da  AmigaOS 3.0 einige bessere Funktionen hat,
  75. habe ich mich etnschlossen, zwei Versionen  von MagicEYE zu erstellen. Eine  für
  76. AmigaOS 2.0 (MagicEYE_37) und eine für AmigaOS 3.0 (MagicEYE_39) und höher.
  77.  
  78. --------------------------------------------------------------------------------
  79.  
  80. Wie wird dieses Programm installiert?
  81.   Es  gibt  fast nichts einfacheres als das:  Man muß nur die richtige Programm-
  82. Version in das WBStartup-Verzeichnis der Startdiskette/-festplatte kopieren. Das
  83. wars dann :-]
  84.  
  85. --------------------------------------------------------------------------------
  86.  
  87. Verwendung:
  88.   Dieses Programm kann man NUR(!) von der Workbench (bzw. WBStartup-Verzeichnis)
  89. aus starten.  Wenn man es von  einer Shell  aus  startet, passiert  nichts! Des-
  90. weiteren fehlt dem Programm eine grafische Oberfäche. D.h. alle Parameter müssen
  91. dem Programm mittels ToolTypes im Icon übergeben werden. Folgende ToolTypes sind
  92. vorhanden:
  93.  
  94.   DONOTWAIT       : Dies ist  eigentlich kein  Parameter  für MagicEYE,  sondern
  95.                     viel mehr ein  Schalter  für die  Workbench.  Dieser Eintrag
  96.                     sollte nicht entfernt werden!
  97.   WIN_X           : Mit diesen beiden Parametern wird die Position der Augen auf
  98.   WIN_Y             dem Bildschirm  festgelegt. Dabei wird von der oberen linken
  99.                     Ecke aus positioniert! Die voreingestellten Werte sind:
  100.                     WIN_X=545  und WIN_Y=1
  101.   DELAY           : Dieser  Wert bestimmt, wie lange das Fenster von MagicEYE ge-
  102.                     schlossen wird, wenn die  Einstellungen des Systems geändert
  103.                     wurden. Als Voreinstellung wurde 5 Sekunden gewählt.
  104.   PRIORITY        : Gibt die Taskpriorität für das System an. Dieser Wert sollte
  105.                     möglichst  unter 0 liegen, damit  Programm,  die  Rechenzeit
  106.                     benötigen diese auch  erhalten. Im  Programm voreingestellte
  107.                     ist der Wert 0, im Icon ist -5 voreingestellt.
  108.   DRAGPATCH       : Mit diesem (NICHT(!)  systemkonformen) Patch ist es möglich,
  109.                     daß man auch mit dem Augen-Fenster den Bildschirm nach unten
  110.                     bzw. zur Seite verschieben kann. Wird dieses Flag angegeben,
  111.                     so ist der  Patch aktiv,  ansonsten wird  dieser Patch nicht
  112.                     durchgeführt.
  113.   SLEEPY          : Mit  diesem Parameter kann  man bestimmen, wie oft die Augen
  114.                     blinzeln  sollen. umso kleiner der Wert, desto häufiger wird
  115.                     geblinzelt. Voreingestellt ist 40. (Einfach mal probieren)
  116.   SLEEP_PERIOD    : Dieser Parameter gibt an, wie lange es dauert, bis die Augen
  117.                     geschlossen  werden, wenn  die  Maus nicht mehr bewegt wird.
  118.                     Voreingestellt ist ein Wert von 50. (Einfach mal probieren)
  119.   FRESHUP_PER_SEC : Dieser  Wert gibt an, wie oft  in der  Sekunde die Augen neu
  120.                     gezeichnet, und  damit,  wie oft die Pupillen an  die  Maus-
  121.                     position  angepasst werden  soll. D.h. wenn hier 1 angegeben
  122.                     wird, dann  bedeutet  dies, das  MagicEYE einmal pro Sekunde
  123.                     die Augen an  die  aktuelle  Mausposition  anpasst. Als Vor-
  124.                     einstellung wurde 50  gewählt  (=> 50mal pro Sekunde). Werte
  125.                     größer als 100  sind nicht  sinnvoll  (oder hat jemand einen
  126.                     Workbench-Screen  mit  mehr als 100Hz?) und damit auch nicht
  127.                     möglich. Dieser Wert sollte  möglichst gut überdacht werden,
  128.                     da  er vorallem  auch  die von MagicEYE benötigte Systemzeit
  129.                     angibt  (Je größer  der  Wert,  desto  häufiger  werden  von
  130.                     MagicEYE die Augen neu berechnet und gezeichnet).
  131.  
  132.   So, daß wäre  eigentlich alles, was man zu diesem Tool wissen müsste. Oder...?
  133. Ach, ich hab noch nicht erzählt, wie man das Programm  beendent? Nun, eigentlich
  134. meine  ich,  daß dieses Programm auf jede  MagicWB-Workbench  gehört. Wenn  aber
  135. jemand dieses Programm  beenden will, dann kann er dies wiefolgt machen: Fenster
  136. aktivieren  (mit der linken  Maustaste  Fenster  anwählen (auf  eines der  Augen
  137. klicken)) und dann die rechte Maustaste drücken (eventuell öfters).
  138.  
  139. --------------------------------------------------------------------------------
  140.  
  141. Was kann man an dem Programm noch verbessern?
  142.   * Man  kann noch ein paar Spielereien  mit den Augen machen (z.B. Augen ab und
  143.     zu rollen lassen).
  144.   * Man  kann  in  der  Version  für  AmigaOS 3.0  und  höher  noch  die  Farben
  145.     automatisch an  die Workbecnh-Farbpalette anpassen lassen (Wenn sich mehrere
  146.     Benutzer melden, die ein solche Möglichkeit benötigen, dann werde ich dieses
  147.     eventuell in einer kommenden Version berücksichtigen).
  148.   * Man  kann davon  ausgehen,  das  noch  irgendwelche  Fehler (undokumentierte
  149.     Möglichkeiten oder gar Käfer ;^) ) enthalten sind, die man entfernen sollte.
  150.  
  151. --------------------------------------------------------------------------------
  152.  
  153. Wer Verbesserungsvorschläge,  Fehler usw. hat, der  kann sollte sich an folgende
  154. Adresse wenden:
  155.  
  156.                  sMail:           Christian Krapp
  157.                                   Hagenmähderstr. 9
  158.                                 D-86391 Stadtbergen
  159.                                   (GERMANY)
  160.                  eMail:           krabbe@informatik.fh-augsburg.de
  161.  
  162. --------------------------------------------------------------------------------
  163.  
  164. Geschichtliches: (xx steht entweder für 37 (AmigaOS 2.04) bzw. 39 (AmigaOS 3.0))
  165.  
  166. Vxx.0   28.04.1995 - Die ersten Arbeiten an dem Programm beginnen (Animationen)
  167. Vxx.1   16.06.1995 - Nach langer Arbeit (und erneutem erstellen der Animationen)
  168.                     ist die erste brauchbare Version fertig.
  169.